SETTINGS
 

There isn't any fancy settings editor, so you need to change the settings with your favorite text editor. The settings for Rainmeter are scattered to several places, but for most of you the Rainmeter.ini is the only place you need to make changes. The general configuration settings are in a Rainmeter.ini-file. The skin settings are in the skin's ini-files. The Litestep's step.rc only has few optional entries, which can be used to define the paths and select the skin.

Important! Some of the settings cannot be changed while Rainmeter is running becase a refresh will write the old values back to the ini-file. So if you cannot change something try to close Rainmeter and change the value after that.

Step.rc

RainmeterIniFile
This can be set to point to the Rainmeter.ini file if it is not placed in the default place (i.e. in the Rainmeter.dll's folder).

RainmeterSkinPath
This defines the path where the skins are. The skins must be in separate subfolders under the given folder.

RainmeterPluginPath
This defines the path where the plugins are.

RainmeterCurrentConfig
The name of current config. This can be used to force the use of some config. You must also define RainmeterCurrentConfigIni.

RainmeterCurrentConfigIni
The name of current config ini-file (only the ini-file, not the path!).

RainmeterWindowX
Sets the window's x-coordinate.

RainmeterWindowY
Sets the window's y-coordinate.

Rainmeter.ini

The file has two main sections [Rainmeter] and [Statistics]. The Rainmeter section contains general settings that can be used to change how Rainmeter behaves. The settings are used as default values for all new configs that are opened. Once the config is opened it will write the settings under its own sertion in the Rainmeter.ini file.  The Statistics section contains some things that few measures store in there. Do not modify them by hand.

One special section is [TrayMeasure], which can be used to define a measure for the tray icon. You can use any measure for this as long as it returns some meaningful values (i.e. numbers between some limits).

These must be put under [Rainmeter]-section (or under the different config sections):

WindowX
X-position of the meter window. Negative values can be used too, in which case the position is relative to right edge of the screen. If Rainmeter is ran inside a lsbox the window position should be set to 0.

WindowY
Y-position of the meter window. Negative values can be used too, in which case the position is relative to bottom edge of the screen.

AllowNegativeCoordinates
If set to 1, the negative coordinates are interpret as negative. If set to 0, they define offset from the bottom right corner of the desktop (like most Litestep modules do).

SavePosition
If set to 1, the position of the window is stored in the Rainmeter.ini file so that it'll be remembered when Rainmeter is executed the next time.

AlwaysOnTop
If set to 1, the window is always on top of other windows. If 0, the window positioning is normal. If set to -1 the window stays back of the other windows. -2 pins the window to desktop and 2 keeps the window on top of other topmost windows. Note that -2 (OnDesktop) only works with Explorer-shell.

Draggable
If set to 1, the window can be dragged around with the mouse. If 0, the window stationary.

SnapEdges
If set to 1, the window will snap to screen edges when moved.

HideOnMouseOver
If set to 1 the meter window will disappear if the mouse pointer is moved on it. The window will reappear when the mouse pointer is moved off the position where the window was. If shift, ctrl or alt is hold while moving the mouse, the window will not disappear (or reappear).

StartHidden
If set to 1, Rainmeter is hidden when started. You can use !RainmeterShow-bang to make it visible.

NativeTransparency
Set to 1 for native transparency support (only for Win2k & XP).

AlphaValue
The transparency value for the window. Use values between 0...255. Only works if native transparency is enabled.

ClickThrough
If set to 1 the mouse clicks go through the window. Only works if native transparency is enabled.

LeftMouseDownAction
Command or a bang that will be executed when the left mouse button is pressed down over the Rainmeter's window. Note that this disables the dragging.

RightMouseDownAction
Command or a bang that will be executed when the right mouse button is pressed down over the Rainmeter's window.

LeftMouseUpAction
Command or a bang that will be executed when the left mouse button is released over the Rainmeter's window.

RightMouseUpAction
Command or a bang that will be executed when the right mouse button is released over the Rainmeter's window. Note that this disables the context menu.

MouseOverAction
Command or a bang that will be executed when the mouse goes over the Rainmeter's window.

MouseLeaveAction
Command or a bang that will be executed when the mouse leaves the Rainmeter's window.

DesktopWorkArea
Sets a new work area for the desktop. The workarea defines the maximized windows cover. Use four comma separated values (e.g. DesktopWorkArea=0,0,1500,1200). Note that moving the taskbar will reset the workarea to Windows' default (changing screen resolution will do the same).

TrayIcon
Set to 0 to get rid of the tray icon.

FadeDuration
This defines the amount of time it takes to fade the window. The time is in milliseconds. To get rid of the fading set the value to 0.

TrayExecuteL, TrayExecuteM, TrayExecuteR, TrayExecuteDL, TrayExecuteDM, TrayExecuteDR
Executes a command or !bang when the tray icon is (double)clicked with the mouse. Note that TrayExecuteR will override the context menu in the tray.

OnRefreshAction
Executes a command or !bang when the config is refreshed. Refresh is done also when the config is opened the first time.

ConfigEditor
Defines the application that is used to edit the Rainmeter's configuration files. The default is Notepad.

 


These must be put under [TrayMeasure]-section:

Measure
The name of the measure which value the tray will show.

TrayMeter
This can be either HISTOGRAM is BITMAP.

TrayColor1
Defines the background color for the histogram.

TrayColor2
Defines the foreground color for the histogram.

TrayBitmap
Defines the name of the bitmap used in the tray. The bitmap can have as many frames as you like but each frame must be 16x16 in size. The path is relative to the Rainmeter's Skins-folder.

It's possible to also use icon files as the tray bitmap. You can use %i in the filename to define an increasing number from 1. E.g. TrayBitmap=tray-%i.ico would read the icons files tray-1.ico, tray-2.ico, tray-3.ico and so on as long as it can find them. The format specification can be used like in printf (e.g. TrayBitmap=tray-%02i.ico will load tray-01.ico, tray-02.ico, ...).